home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / comm / cnet / clist082.lha / clist / CList.doc < prev   
Text File  |  1995-10-06  |  6KB  |  178 lines
  1.  
  2.  
  3.  
  4.                              CList V0.82 (06/10/95)
  5.                                by Florian Lohoff
  6.  
  7.  
  8.  
  9.  
  10.  
  11. 1. Distribution & Usage
  12.  CList and all related documentation are freeware and may be freely
  13.  distributed and copied. It may not be distributed in a modified form.
  14.  It may not be used for commercial purposes.
  15.  
  16.  CList may not be included in CD-Rom productions if the end user
  17.  price is higher than 30,- DM.
  18.  
  19.  You use CList at your own risk. This program is provided 'as is' without
  20.  any warranty.
  21.  
  22.  Please send me an EMail or anything you like and tell me how great
  23.  you think this tool is :)
  24.  
  25.  
  26. 2. Introduction
  27.  CList is a CNet V3.05c+ Filelister tool. Another ? Yes it is another
  28.  tool. But i tested lots and i didn`t find what i searched.
  29.  
  30.  I had a long discussion with Jens Boenisch about his MBLister. I proved
  31.  him lots of bugs but he always stood on the point that his MBLister (V2.3)
  32.  was Bug free. So i decided to write my own.
  33.  (Look into the SHOWPATH option MB2.2 trashes MB2.3 crashes)
  34.  
  35.  
  36. 3. Requirements
  37.  An AMIGA would be nice. OS2 (Kick 37+) and C-Net V3.05 or other
  38.  versions (not tested). Assigns should be done on execution.
  39.  
  40.  
  41. 4. Usage
  42.  CList <config>
  43.  
  44.  The config file name is optional. If you do not supply one CList trys
  45.  to open "CList.cfg".
  46.  
  47.  Following keywords may appear in the Config file:
  48.  
  49.    Output  -  Defines a new filelist. You may use up to 256 filelists
  50.               in one configuration. All keywords below this until the
  51.               next output belong to this filelist
  52.    Days    -  Number of days to list in past (If 0 or left out, all files)
  53.    Header  -  The Header file added above the filelist.
  54.    Footer  -  The Footer file added below the filelist.
  55.    Pattern -  Now this is the most importent thing in this config file.
  56.               You may define up to 1024 patterns for every config file.
  57.               These pattern are the OS 2.0 normal patternmatching.
  58.  
  59.               Example:
  60.                  Pattern #?             - Lists all subdirectorys
  61.                  Pattern Amiga/Local#?  - Lists all subdirectorys in Amiga
  62.                                           which start with "Local"
  63.                  Pattern ~(Amiga#?)     - Lists all subdirectorys
  64.                                           except all dirs starting with
  65.                                           Amiga + subdirs.
  66.  
  67.               This is the way CList builds the to match paths.
  68.  
  69.               Repair Sub output         |     Paths build by CList
  70.               --------------------------+-------------------------------
  71.               Upload base               |     ""
  72.                   Amiga                 |     "Amiga"
  73.                       Uploads           |     "Amiga/Uploads"
  74.                       Local             |     "Amiga/Uploads/Local"
  75.                           DFUE/NET/COMM |     "Amiga/Uploads/DFUE/NET/COMM"
  76.                           DISK          |     "Amiga/Uploads/DISK"
  77.                           PACKER        |     "Amiga/Uploads/PACKER"
  78.                           [...]         |     [...]
  79.  
  80.  
  81.    Look into the example configuration file for more infos.
  82.  
  83.  
  84. 5. History
  85.  
  86.  0.5  (23.8.95) - First running version
  87.  0.51 (20.9.95) - Changed some behaviour
  88.  0.52 (21.9.95) - Removed bug with files with no description
  89.  0.53 (24.9.95) - Removed enforcer hit in argument parsing
  90.  0.6  (24.9.95) - Added multilist support
  91.                 - Maximum List is 256, maximum patterns per list is 1024
  92.                 - Reduced memory fragmentation (MemoryPools)
  93.                 - Removed enforcer hit in file info generation
  94.  0.7  (24.9.95) - Add header&footer support
  95.                 - Added default configuration file name (clist.cfg)
  96.  0.71 (30.9.95) - Changed finding of "Upload base"
  97.                   case sensitive search of subdir title caused problems ...
  98.                   changed to search first sub with "UDBase" flag
  99.                   thanks Giorgini Manuel for reporting bug.
  100.  0.8  (6.10.95) - Added DAYS to create "Newfiles" types of lists
  101.  0.81 (6.10.95) - Optimized for size
  102.  0.82 (6.10.95) - Made breakeable (CTRL-C)
  103.  
  104.  
  105. 6. Future
  106.  
  107.  Future enhancements will only be done if i get feedback from users of this
  108.  tool who like to use it.
  109.  
  110.  - PACK(Execute) keyword
  111.  - Parser for Header/Footer for Date
  112.    %d - Date (10.05.94)
  113.    %t - time (10:20:30) 24h
  114.    %b - total bytes (No decimals)
  115.    %f - total files (No decimals)
  116.    %c - total dirs (No decimals)
  117.    %n - Name of list
  118.    %p - Program id
  119.  - [unvalidated] [unfinished] strings add
  120.  - Do not show deleted files
  121.  - bytes/files In subdirheader
  122.  - MARKDAYS Keyword for marking files with "*"
  123.  - Buffered output
  124.  
  125.  and maybe even more if you report me.
  126.  
  127.  
  128. 7. Bugs
  129.  
  130.  Report any bug you find and which is not listed below. Read documentation
  131.  carefully before writing a bug report. Maybe it is a feature. Then report
  132.  the bug. Report Amiga type, memory total, memory on execution, Guru number,
  133.  HD space left. Everything which could be in relation with the crash.
  134.  
  135.  I know that there are some bugs. (No program is bug free) but i don`t know
  136.  any exactly ...
  137.  
  138.  
  139. 8. Author
  140.  My name is Florian Lohoff. I am 20 years old and doing my "Zivildienst".
  141.  I have got an amiga since end of 1987. My first Amiga was an A500
  142.  then another one because of a hardware derepair of my old. Then a Harddrive
  143.  (20MB for 1200,-DM). Then a A2000 with 100MB Harddrive and 5MB of Ram.
  144.  Now i own a A3000T with 1.8GB HD and 14MB in a PC tower case. I am running
  145.  a BBS with 7 lines. I always programmed a lot in Assembly.  Then someday
  146.  i discovered "C" and tried around. Anyone interested in Electronics &
  147.  Programming feel free to contact me. Now i am programming on an A3000T040
  148.  with 240MB HD and 18MB of ram because my BBS A3000T is to busy with the BBS.
  149.  
  150.  
  151.  Mailbox:
  152.  Dataland
  153.  +49 (0)5241-340796 Zyxel 1496E+
  154.              3286   V.FC/V.32B
  155.              3287   V.34/V.FC/V.32B
  156.              3288   V.32B
  157.              3289   V.32B/V.32Terbo
  158.            337180   V.34/V.32B/V.32Terbo
  159.            337181   2400
  160.  
  161.  Fido:     Florian Lohoff@2:2449/845
  162.  AmigaNet: Florian Lohoff@39:170/110
  163.  InterNet: flohoff@dataland.owl.de
  164.  
  165.  Actual version may be requested with magic "CList". Mailer is running on all
  166.  lines.
  167.  
  168.  Snail Mail:
  169.  Florian Lohoff
  170.  Heidestr 16
  171.  33330 Guetersloh
  172.  Germany
  173.  
  174.  Voice:
  175.  +49 (0)5241 34865
  176.  
  177.  
  178.